GetStrongStorageUnitRef

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODStorageUnit

GetStrongStorageUnitRef
The GetStrongStorageUnitRef method creates a strong persistent reference to the specified storage unit.
void GetStrongStorageUnitRef (
                           in ODStorageUnitID embeddedSUID, 
                           out ODStorageUnitRef strongRef);
embeddedSUID
The storage-unit ID of the storage unit whose persistent reference is desired.
strongRef
A persistent reference to the storage unit specified by the embeddedSUID parameter.

DISCUSSION
Before you call this method, you should focus this storage unit on the value where you want to store the strong persistent reference. After this method executes successfully, call the SetValue method to store the resulting persistent reference, returned in the strongRef output parameter, into the currently focused value.

IMPORTANT
The scope of a persistent reference is limited to the value in which it was created. If you store the persistent reference in a different value, it will almost certainly not refer to the correct storage unit.

EXCEPTIONS

kODErrIllegalNullStorageUnitInput
The embeddedSUID parameter is null.
kODErrUnfocusedStorageUnit
This storage unit is not focused on a value.
kODErrZeroRefCount
This storage unit has a reference count of 0.

SEE ALSO
The ODStorageUnitID type (page 903).
The ODStorageUnitRef type (page 903).
The ODStorageUnit::GetWeakStorageUnitRef method (page 699).
The ODStorageUnit::IsStrongStorageUnitRef method (page 703).
The ODStorageUnit::SetValue method (page 714).
"Creating Persistent References" on page 281 in OpenDoc Programmer's Guide.
"Persistent References and Cloning" on page 282 in OpenDoc Programmer's Guide.
"Creating Additional Storage Units" on page 301 in OpenDoc Programmer's Guide.